Accepted Request Values
This reference consolidates the allowed values for coverage selection fields (used in rateShopCoverageSelections, selectedCoverage, and pet update endpoints) and the pet age tokens used in quote requests.
Use this page to:
- Validate user input before calling the quote endpoints.
- Map UI selections (numeric or word form) into the API’s accepted string tokens.
- Avoid inadvertent clearing of analytics or coverage fields caused by typos.
Coverage Selection Fields
Coverage-related request objects accept EITHER a canonical word token OR its numeric string equivalent (where shown). Always send them as strings. Do not send bare numbers.
Authoritative schema (always check for newest values): CoverageSelection Definition
| Field | Word Tokens | Numeric String Tokens | Notes |
|---|---|---|---|
reimbursementPercentage |
Seventy, Eighty, Ninety |
"70", "80", "90" |
Percent of eligible costs reimbursed |
annualWellnessReward |
None, TwoHundredFifty, ThreeHundred, FourHundredFifty, FiveHundred, SixHundredFifty, SevenHundred |
"0", "250", "300", "450", "500", "650", "700" |
None/"0" = no wellness add‑on |
annualDeductible |
OneHundred, TwoHundred, TwoHundredFifty, ThreeHundred, FiveHundred, SevenHundredFifty, OneThousand |
"100", "200", "250", "300", "500", "750", "1000" |
Deductible before reimbursement |
annualReimbursementLimit |
TwoThousand, FiveThousand, EightThousand, TenThousand, FifteenThousand, ThirtyThousand, Unlimited |
"2000", "5000", "8000", "10000", "15000", "30000", "-1" |
Unlimited represented as "-1" |
| Flags | examFeeCoverage, drugDentalCoverage |
(boolean) | Always literal true / false |
Validation Tips
- Reject unknown tokens (e.g.,
Seventyy) before sending to the API. - Normalize user numeric input into strings (e.g., user picks 500 → send
"500"). - Preserve the exact casing of word tokens (PascalCase) for schema alignment.
- When displaying coverage options, store both the word and numeric forms if you need to support toggling display styles.
Pet Age Values
The age (new pet) or ageInYears (update pet endpoint) fields must be one of the following accepted tokens. These represent discrete age buckets used for rating.
SixWeeksToTwelveMonths, One, Two, Three, Four, Five, Six, Seven, Eight, Nine,
Ten, Eleven, Twelve, Thirteen, Fourteen, Fifteen, Sixteen, Seventeen, Eighteen,
Nineteen, Twenty, ZeroWeeksToSixWeeks
Usage Guidance
- Map numeric UI ages (e.g. 2 →
Two) before sending. - Do not send digits (
"2") or lowercased variants (two). They will fail validation.
Example Snippet
"pets": [
{ "name": "Riley", "breedId": 452, "gender": "Female", "age": "Two" },
{ "name": "Shadow", "breedId": 318, "gender": "Male", "age": "Nine" }
]
Related Documentation
- Quoting workflow: Quoting Guide
- Conceptual explanations (analytics, frequency, retention): Additional Concepts
- Pet update endpoint: See Update a Pet on the Quoting page.
If you notice a mismatch between this list and the live API schema, open an issue so we can reconcile and update quickly.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.